home *** CD-ROM | disk | FTP | other *** search
/ Die Ultimative Software-P…i Collection 1996 & 1997 / Die Ultimative Software-Pakete CD-ROM fur Atari Collection 1996 & 1997.iso / a / a_funk / maputil / maputil.txt < prev   
Encoding:
Text File  |  1996-10-30  |  6.7 KB  |  135 lines
  1. +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
  2. +-+  Dokumentation zu:      MAPUTIL.TTP                               +-+
  3. +-+                         (ex MAPUPD.TTP)                           +-+
  4. +-+  programmiert von:      Karsten Heddenhausen DC7OS                +-+
  5. +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+--+-+-+-+-+-+-+-+-++-+-+-+-+-+-+-+-+-+-+
  6.  
  7. MAPUPD ist ein kleines Progrämmchen, welches ein Update der HamMap - 
  8. Daten durchführt. Die HamMap - Daten werden auch auf dem ATARI von vielen 
  9. Programmen genutzt. Damit die Daten aktuell bleiben und nicht ständig der 
  10. komplette Datenbestand in die Boxen eingespielt werden muß, wurde ein 
  11. Format definiert, in dem beschrieben wird, welche Daten wie zu ändern 
  12. sind. 
  13.  
  14. Genau diese Änderungen führt MAPUPD durch. Dazu braucht es ZWEI Parameter 
  15. bei dem Aufruf. Als erstes ist der Dateiname der Daten, die als Grundlage 
  16. für das Update herhalten sollen anzugeben (ohne Extension), dahinter der 
  17. volle Dateiname der Datei, die das Update enthält.
  18.  
  19. Wird einer der benötigten Files nicht gefunden, so wird eine Fehlermeldung
  20. erzeugt und das Programm mit dem EXIT-Code -1 abgebrochen. Mit dem gleichen
  21. EXIT-Code wird das Programm auch verlassen, wenn beim Lesen oder Schreiben
  22. Dateien ein Fehler auftrat.
  23.  
  24. Als erstes werden dann die Stationsdaten, danach die Link-Daten 
  25. eingelesen. Wenn dieses erfolgreich abgeschlossen wurde, wird mit Hilfe 
  26. der Update-Datei das Update durchgeführt. Dabei behandelt MAPUPD die 
  27. Befehle MS: (Modify Station) und AS: (Add Station), sowie ML: (Modify 
  28. Link) und AL: (Add Link) jeweils gleich (siehe nächsten Absatz). Danach 
  29. werden die modifizierten Listen sortiert und, wenn kein Fehler 
  30. aufgetreten ist, wieder zurückgeschrieben. Eventuell aufgetretene Fehler 
  31. werden in einer Datei protokolliert, die den gleichen Namen wie die 
  32. Update-Datei hat (mit der Extension .ERR). 
  33.  
  34. Wenn vor den Namen der Update-Daten ein "+" geschrieben wird, so werden
  35. die "alten" Daten werden in STATION.OLD bzw. LINK.OLD gesichert. Ansonsten
  36. werden sie einfach überschrieben.
  37.  
  38. Ich habe mich entschieden, die "Modify" und "Add" Befehle im Update 
  39. gleich zu behandeln, da nicht immer sichergestellt sein kann, daß nicht 
  40. bei 2 kurz hintereinander folgenden Updates ein paar Zeilen schon 
  41. vorhanden sind, die in dem nächsten dann nochmal hinzugefügt werden 
  42. sollen. Wenn man nur die Updates, die von Helmut DG8FBL und Martin DL6DW 
  43. eingespielt werden, verwendet, sollte dieses aber eigentlich nicht 
  44. vorkommen. Wie gesagt, dieses Feature ist nicht Standard, deswegen 
  45. verlaßt Euch bitte nicht darauf, daß es überall so arbeitet.
  46.  
  47. Bei einem Update wird das Datum in den Update-Zeile herangezogen, um fest-
  48. zustellen, ob die Daten wirklich neu sind. 
  49.  
  50.  
  51. Aufruf:
  52.  
  53. MAPUPD liste update          ; führt update in liste.STN und liste.LNK durch
  54. MAPUPD liste +update         ; sichert die alten Daten in STATION.OLD und 
  55.                              ; LINK.OLD
  56.  
  57. Erweiterung (10.10.93)
  58. Wird statt dem Namen der Update-Datei ein "-r" eingegeben, so werden re-
  59. dundante Informationen entfernt. Dieses ist sehr hilftreich, wenn die Daten
  60. mit einem Programm als Autorouter arbeiten müssen. So wird bei einem Digi-
  61. peater mit mehreren LinkNodes nur noch der Digipeater aufgeführt und alle
  62. Links zu ihm umgeleitet. Ab und zu findet man unter einer SSID auch nur einen
  63. weiteren Benutzerzugang. Dieser wird hier als Zusatzzeile unter dem eigent-
  64. lichem Call abgelegt. Die so aufbereiteten Daten werden als DIGIINFO.STN und
  65. DIGIINFO.LNK abgelegt. 
  66.  
  67. Aufruf:
  68. MAPUPD liste -r              ; entfernt redundante Information
  69.  
  70. Erweiterung (26.11.93)
  71. MAPUPD wird um die Funktion zum Testen der Daten erweitert und in MAPUTIL
  72. umbenannt. Bei dem Aufruf können folgende Parameter angegeben werden:
  73.  
  74.       MAPUTIL daten upd -r -o -c
  75.  
  76. Die Schalter haben folgende Bedeutung:
  77.       -r    redundante Daten entfernen
  78.       -o    alte Daten sichern
  79.       -c    Daten testen
  80.  
  81. Dabei ist zu beachten, daß beim Testen der Daten KEIN Update durchgeführt 
  82. werden kann. 
  83.  
  84. Weitere Infos zum Testen der Daten stehen in CHKMAP.TXT, da die 
  85. Funktionen aus diesem Programm übernommen wurden.
  86.  
  87. Erweiterung (01.01.94)
  88. Beim Testen der Daten wird auch auf "sinnvolle" Kombinationen von Typ,
  89. Soft- und Hardware geachtet. Ob dieses sinnvoll ist, bei den Einschränkungen,
  90. die HamMap vorgibt, sei mal dahin gestellt. So gibt es bei UserNodes als 
  91. Hardware entweder einen PC oder einen TNc, ein Atari St darf demnach nicht
  92. bei den Usern benutzt werden :-)
  93. Aber was Interessiert uns HamMap?
  94.  
  95. Hinweis (07.04.94)
  96. Die Option "Daten testen" liefert viele Meldungen, die nur für die Datensammler
  97. und ähnliche neugierige Leute interessant sind. Bei den zur Zeit aktuellen 
  98. Daten wird ein File mit einer Größe von über 200kB erzeugt.
  99. Die meisten Meldungen sind Warnungen (W# am Anfang der Zeile), sie geben an,
  100. daß dort was nicht ganz in Ordnung ist, dieses aber nicht die ordnungsge-
  101. mäße Verarbeitung der Daten stört. Anders ist dieses bei Fehlermeldungen
  102. (F# am Anfang der Zeile), hier wurde ein Fehler gefunden, der eine ordnungs-
  103. gemäße Weiterverarbeitung der Daten, aller Wahrscheinlichkeit nach, stören 
  104. wird.
  105. Wer irgendwelche Knoten findet, die nicht in den Daten verzeichnet sind, bzw. 
  106. bei denen sich irgendwas geändert hat, der möge doch mal folgende Daten von 
  107. demjenigen Knoten protokollieren und an Helmut DG8FBL bzw. Martin DL6DW 
  108. schicken, damit die Änderungen dann in das nächste Update einfliessen können.
  109. TheNet/TheNetNode: I(nfo), A(ktuelles), R(outes), P(Arameter), S(tatistik)
  110. FlexNet:           I(nfo), A(ktuelles), L(inks), P(arameter)
  111. BayCom:            I(nfo), A(ktuelles), L(inks), PAR(ameter)
  112.  
  113. Änderungen (23.03.95):
  114. Die Software der einzelnen Knoten wird weiterentwickelt, also muß der 
  115. Test auf "sinnvolle" Kombinationen von Hard- und Software auch 
  116. erweitert werden. Undwenn ich schon mal am ändern bin, habe ich ein 
  117. paar Sachen noch etwas beschleunigt. 
  118.  
  119. #########################  W  I  C  H  T  I  G ##########################
  120.  
  121. Fuer  die  Weitergabe  des  Programms  ist  die allgemeine Lizenz fuer 
  122. Amateurfunksoftware (ALAS) zu beachten. Eine  Anpassung  der  Programme an 
  123. das  MultiTOS  sollte moeglich sein, wenn mir die  entsprechenden 
  124. C-Bindings  vorliegen.  Eine  Portierung  auf  andere Rechnersysteme  ist 
  125. relativ  einfach  durchzufuehren,  da  fast nur Standardroutinen verwendet 
  126. wurden.  Nur  Teile  der  Textausgabe  auf  dem  Bildschirm  bedarfen 
  127. einer Anpassung,  da  hier  es sich natuerlich nicht vermeiden laeßt, 
  128. irgendwelche Systemabhaengigen Sachen einzubauen :-)
  129.  
  130. Wer  moechte,  kann  dem  Programmautor  (naemlich mir) eine kleine 
  131. Anerkennung zukommen lassen.
  132. Karsten Heddenhausen DC7OS
  133. Paulstraße 1A
  134. 30167 Hannover
  135.